home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_2 / execmaster / execmaster.dok < prev    next >
Encoding:
Text File  |  1992-10-12  |  15.5 KB  |  593 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                        ANLEITUNG DOKUMENTATION ZU
  12.  
  13.  
  14.                 ExecMaster  VERSION  1.7   FREEWARE VERSION
  15.  
  16.  
  17.                         geschrieben 1992 von H.P.G.
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. INDEX:
  64.  
  65.  
  66.         Index                           Seite   2
  67.  
  68.         Allgemeine Beschreibung                 3
  69.  
  70.         SYSTEM Vorraussetzungen                 3
  71.  
  72.         Rechtliches                             4
  73.  
  74.         Features                                5
  75.  
  76.         Installation                            5
  77.  
  78.         Starten von ExecMaster                  6
  79.  
  80.         ExecMaster Start PARAMETER              7
  81.  
  82.         Beschreibung des Intuition Interfaces   8,9
  83.  
  84.         Technisches                             10
  85.  
  86.         Zum Schluß                              10
  87.  
  88.         Adresse                                 10
  89.  
  90.  
  91.         Anhang:
  92.  
  93.  
  94.                 Liste der Dateien
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. Allgemeine Beschreibung:
  117.  
  118.  
  119.         ExecMaster [ EM ] ist ein Programm, daß den  Menüpunkt  'Execute
  120.         Command' der WBench 2.xx ersetzt.
  121.  
  122.         - Mit EM kann man  Cli-Kommandos,  ARexx-Scripts,  Batch-Scripts
  123.           oder auch 'nur' einzelne Programme ausführen.
  124.  
  125.         - Die Standartausgabe kann dabei beliebig umgelenkt werden.
  126.  
  127.         - Es lassen sich Listen oder Batch-Dateien erzeugen.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. SYSTEM Vorrausetzungen:
  136.  
  137.  
  138.  
  139.         Für EM benötigt man mindestens Kickstart  2.xx  und  ASL.Library
  140.         37.xx.
  141.  
  142.         Man muß die Befehle Run, Execute im aktuellen AmigaDOS  Suchpfad
  143.         installiert haben.
  144.  
  145.         Um alle Fähigkeiten von EM auszunutzen, sollte man auch  den  Rx
  146.         Befehl im aktuellen AmigaDOS Suchpfad haben.
  147.  
  148.         Ansonstens gibt es keine weiteren Einschränkungen.
  149.  
  150.  
  151.         NOTIZ: Da EM regen gebrauch der neuen OS 2.0 Features macht, ist
  152.                das Programm unter 1.2 1.3 leider nicht lauffähig.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173. Rechtliches:
  174.  
  175.  
  176.         Ich habe mich entschlossen, ExecMaster Version 1.5 und alle beige-
  177.         fügten Dateien und Scripts, sowie aller Anleitungen als FREEWARE
  178.         zu deklarieren.
  179.         D.H.:
  180.  
  181.             Jeder kann EM benutzen.
  182.             Jeder darf EM weitergeben, wenn:
  183.  
  184.                 1. alle unten aufgeführten Programme mit weitergegeben
  185.                    werden,
  186.  
  187.                 2. keinerlei Veränderungen unten aufgeführten Programmen
  188.                    vorgenommen wurden,
  189.  
  190.                 3. bei Nachkompilierungen der Quell-Codes muß ein Hinweis
  191.                    auf den Orginal-Programmierer vorhanden sein, bei He-
  192.                    rausgabe dieser, muß eine Kopie an mich gesandt werden.
  193.  
  194.                 4. EM darf nicht verkauft werden.
  195.  
  196.                        Außnahme: Es darf eine geringe Kopiergebühr erhoben
  197.                                  werden, die aber 5 DM bzw. den entsprechenden
  198.                                  Gegenwert in anderen Währungen nicht über-
  199.                                  steigt.
  200.  
  201.                 5. EM darf nur als Teil eines kommerziellen Produktes herraus-
  202.                    gegeben werden, mit ausdrücklicher schriftlicher Genehmigung
  203.                    des Autors (Adresse siehe unten).
  204.  
  205.                 Zuwiderhandlungen der oben Aufgeführten Konditionen werden
  206.                 Zivilrechtlich verfolgt.
  207.  
  208.  
  209.         Ferner wird für die Funktion des Programmes ,sowie möglicher Folgen
  210.         der Benutzung des Programmes sowie der u. a. Dateien, keinerlei Ge-
  211.         währleistung übernommen. Alle Risiken trägt der Benutzer allein.
  212.  
  213.         (Ich kann mir allerdings nicht vorstellen, daß bei sachgemäßer Be-
  214.          nutzung der Programme, Schäden entstehen)
  215.  
  216.  
  217.  
  218.  
  219.         So nun zum interessanteren Teil:
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232. FEATURES:
  233.  
  234.  
  235.         - EM besitzt eine vollkommen  mausgesteuerte  GadTools-Benutzer-
  236.           Oberfläche.
  237.  
  238.         - Alle Funktionen lassen sich auch durch Tastendruck entsprechen-
  239.           der Buchstaben aufrufen.
  240.  
  241.         - Man kann ganze Kommandozeilen eingeben.
  242.  
  243.         - Man kann Rexx-Scripts ausführen.
  244.  
  245.         - Man kann Batch-Scripts ausführen.
  246.  
  247.         - Man kann Programme aufrufen.
  248.  
  249.         - Die Standartausgabe kann beliebig umgelenkt werden.
  250.  
  251.         - EM läßt sich Iconifizieren (verkleinern des Fensters).
  252.  
  253.         - Auch verkleinert sind alle Funktionen  mittels  Tasten  auszu-
  254.           führen.
  255.  
  256.         - Alle Kommandos und/oder Programme lassen sich durch  eine  Da-
  257.           teiauswahlbox  (ASLFileRequester)  per  Mausklick   auswählen.
  258.  
  259.         - Alle Koordinaten des großen, sowie des verkleinerten  Fensters
  260.           lassen sich durch PARAMETER-Übergabe beim Start angeben.
  261.  
  262.         - Die Breite des verkleinerten Fensters läßt sich beim Start an-
  263.           geben.
  264.  
  265.         - Verschiedene Voreinstellungen lassen sich ebenfalls beim Start
  266.           angeben.
  267.  
  268.         - Für einige  SystemGadgets  (ZoomGadget  CloseGadget)  bestehen
  269.           ebenfalls Tastaturkommandos, um nicht zur Maus greifen zu MÜSSEN.
  270.  
  271.         - Volle PublicScreens-Unterstützung. D. H. EM öffnet sein Fenster
  272.           immer auf dem DefaultPublicScreen.
  273.  
  274.         - Alle Gadgets haben org. WB 2.xx Design und Funktion.
  275.  
  276.         - Keine BUSY-LOOPS
  277.  
  278.  
  279.  
  280.  
  281. Installation:
  282.  
  283.  
  284.         Einfach ExecMaster ins C: oder jedes beliebig andere Verzeichnis
  285.         im aktuellen AmigaDOS-Suchpfad kopieren.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295. Starten von ExecMaster:
  296.  
  297.  
  298.  
  299.         EM muß vom CLI aus  gestartet  werden,  wenn  man  PARAMETER  an
  300.         das Programm übergeben will. Alternativ dazu kann man  auch  den
  301.         WBenchmenüpunkt 'ExecuteCommand' ausführen.
  302.  
  303.         Natürlich ist es auch möglich ExecMaster  durch  Doppelklick  zu
  304.         startet; nur muß man dann mit den Voreinstellungen des Programms
  305.         vorliebnehmen.
  306.  
  307.         Will man ExecMaster immer über die Workbench aus starten, ist es
  308.         sinnvoll  ein  Projekt-Piktogramm   zu   erstellen.   Dann   als
  309.         DefaultTool c:IconX eingeben und es dann z.B.  unter  dem  Namen
  310.         EMaster.info abzuspeichern.
  311.  
  312.         Dann schreibt man einen ASCII_Text der
  313.         z.B.
  314.  
  315.  
  316.                ExecMaster CMD dir df0: ICONIFY
  317.  
  318.  
  319.         enthält. Diesen Text muß man dann als EMaster  abspeichern.  Nun
  320.         kann EM durch Doppelklick mit PARAMETER-Übergabe gestartet werden.
  321.  
  322.         Ein Nachteil dabei ist, daß das Fenster von IconX geöffnet bleibt,
  323.         bis EM beendet wird. Dies kann man umgehen, indem man z. B.
  324.  
  325.  
  326.               RUN >NIL: ExecMaster .......
  327.  
  328.  
  329.         angibt. Hierbei muß man beachten, daß in diesem Fall ein  Output
  330.         (siehe unten) angegeben werden muß, wenn man  Ausgaben  der  ge-
  331.         starteten Programme wünscht.
  332.  
  333.  
  334.  
  335.         Ein Beispiel für EMaster wäre:
  336.  
  337.  
  338.         RUN >NIL: ExecMaster OUTP "CON:0/0///EM_Output/WAIT" OUTON
  339.  
  340.  
  341.         Das WAIT ist dann sinnvoll, wenn man ein  CLI-Kommando  aufrufen
  342.         will. Läßt man WAIT weg, schließt sich das Fenster sofort  nach-
  343.         dem das Komando ausgeführt wurde, ohne  dem  Benutzer  Zeit  zum
  344.         Lesen der Ausgabe zu lassen. Mit  WAIT  wird  das  Fenster  erst
  345.         geschlossen, wenn man im CLI-Fenster CTRL-\ eingibt.
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352. ExecMaster START PARAMETER:
  353.  
  354.  
  355.         EM hat folgende
  356.  
  357.  
  358. Synatx: ExecMaster  CMD/K,OUTP/K,ICONIFY/S,OUTON/S,X/N,Y/N,ZX/N,ZY/N,ZW/N
  359.  
  360. dabei ist:
  361.  
  362. *       CMD           Zeichenkette     gibt man CMD gefolgt von einer Zeichen-
  363.                                        kette an, so wird diese Zeichenkette
  364.                                        beim Öffnen des Fensters in das Command-
  365.                                        StringGadget kopiert. (siehe unten)
  366.  
  367. *       OUTP          Zeichenkette      gibt man OUTP an, so wird diese Zeichen-
  368.                                        kette beim Öffnen des Fensters in das Out-
  369.                                        put StringGadget kopiert, (s.u.)
  370.  
  371. *       ICONIFY       ------------     gibt man ICONIFY an startet EM gleich mit
  372.                                        verkleinertem Fenster
  373.  
  374. *       OUTON         ------------     gibt man OUTON an, so wird die CheckBox
  375.                                        aktiviert, d.h. sie wird mit Haken dar-
  376.                                        gestellt. Ist die CheckBox aktiviert,
  377.                                        wird die Standartausgabe zu der im Out-
  378.                                        putStringGadget angegeben Ausgabe umge-
  379.                                        leitet.
  380.                                        Voreinstellung: Unlenkung AUS
  381.  
  382. *       X             Zahlenwert       wird x gefolgt von einer Zahl angegeben,
  383.                                        Öffnet EM sein Fenster mit der linken Ecke
  384.                                        an dieser X-Koordinate. Ist X größer als
  385.                                        der Bildschirmrand, wird der Wert korri-
  386.                                        rigiert ( das gilt ebenfalls für alle
  387.                                        anderen Zahlenwerte ).
  388.  
  389. *       Y             Zahlenwert       gibt die obere Kante an
  390.  
  391. *       ZX            Zahlenwert       gibt die linke Kante des verkleinerten
  392.                                        Fensters an.
  393.  
  394. *       ZY            Zahlenwert       gibt die obere Kante an
  395.  
  396. *       ZW            Zahlenwert       gibt die Breite des verklienerten Fensters
  397.                       361 > ZW > 119   an. Ist sie außerhalb des Bereichs von 120
  398.                                        bis 360, wird sie ignoriert.
  399.                                        Durch diesen Parameter kann man häßliche
  400.                                        Lücken vermeiden, die entstehen, wenn man
  401.                                        noch andere verkleinerte Fenster ( z.B.
  402.                                        Uhren oder TrackDisplays) zur gleichen
  403.                                        auf dem Bildschirm hat.
  404.  
  405. *** Startet man EM ohne PARAMETER oder von der WBench per Doppelklick, bleiben
  406. *** die StringGadgets leer. Das verkleinerte Fenster erscheint an den Koordina-
  407. *** ten 0,0; das Hauptfenster in der Mitte des Bildschirms.
  408. *** Beim Start von der Workbench, mittels Doppelklick auf EMs Icon, ist die
  409. *** CheckBox immer aktiv.
  410.  
  411. Beschreibung des Intuition Interfaces:
  412.  
  413.  
  414.             Es folgt nun eine Beschreibung der Funktionen von EM und deren
  415.             Benutzung:
  416.             ( Die Buchstaben in den beiden eckigen Klammern '[]' repräsentieren
  417.             die äquivalenten Gadgets.
  418.  
  419.     Command [c|C] (d.h. Eingabe von c oder C)
  420.  
  421.             Dies aktiviert das Command String Gadget. Man kann den Namen des
  422.         Kommandos, daß man ausführen will, darin eingeben. Gibt man zum
  423.         Abschluß statt RETURN TAB ein wird das nächste StringGadget aktiviert
  424.         ; SHIFT TAB aktiviert hingegen das vorherige. (Probieren).
  425.  
  426.     Output  [o|O]
  427.  
  428.             Dies aktiviert das Output String Gadget. Man kann hier einen Output
  429.         angeben, den das Kommando als Ausgabe benutzt. Man kann hier z.B.
  430.         einfach 'CON:' eingeben, um das Standart Shell-Fenster zu als Output
  431.         erhalten. Man kann aber auch einen vollständigen Dateinamen eingeben,
  432.         der dann stattdessen benutzt wird. Z. B.:
  433.  
  434.                 gibt man 'Ram:Datei' als Output an und
  435.  
  436.                          'dir c:'    als Kommado, erhält man eine Datei in der
  437.                          Ram Disk mit dem Namen Datei, das eine Liste
  438.                          aller Dateien im C: - Verzeichnis enthält.
  439.  
  440.                z.B.
  441.  
  442.                     ......
  443.                     addbuffers
  444.                     avail
  445.                     ......
  446.  
  447.             Will man keinen Output kann man einfach die CheckBox rechts neben
  448.             dem StringGadget inaktivieren ( = default ). siehe nächster Punkt.
  449.  
  450.             Der Input kann nicht umgelenkt werden.
  451.  
  452.  
  453.     | |     [+]
  454.  
  455.             Die CheckBox (rechts neben dem Output String Gadget) gibt an, ob der
  456.         Output (siehe unten) benutzt werden soll, oder nicht. Ist die Check
  457.         Box 'abgehakt', wird er benutzt, sonst nicht. Dies ist nützlich wenn            man verschiedene Outputs ausprobieren will oder z.B. eine Liste in
  458.         ein File anspeichern will. So kann man zuerst den Namen der Zieldatei
  459.         bei Output eingeben und die CheckBox inaktivieren dann z.B. List ein-
  460.         geben. Es erscheint ein Listing des momentanen Directorys. Ist die
  461.         Ausgabe zufriedenstellend, 'hakt' man die CheckBox (aktiviert) ab und
  462.         das Listing wird in die Zieldatei geschrieben.
  463.  
  464.  
  465.  
  466.  
  467.     RUN     [r|R]
  468.  
  469.             Durch Wahl von Run wird das Kommando mittels C:Run im Hintergrund           gestartet. Auch hier werden alle Ausgaben in den spezifizierten Out-
  470.         put umgelenkt.
  471.  
  472.     Script  [s|S]
  473.  
  474.             Damit kann man eine Batch Datei starten. Diese wird mittels
  475.         C:Execute gestartet. Dies ist dann nützlich wenn die Batchdatei
  476.         das ScriptBit nicht gesetzt hat.  Ist  das  s-Bit  aber  gesetzt
  477.         reicht es, die Batchdatei einfach durch CMD (siehe unten) aufzu-
  478.         rufen.
  479.  
  480.     Rexx    [x|X]
  481.  
  482.             Dies startet ein Rexx Script mittels dem rx Kommando, was sich
  483.         irgendwo im AmigaDOS Suchpfad befinden sollte. (normalerweise ist
  484.         dies REXX: (sys:rexx))
  485.  
  486.     Select  [e|E]
  487.  
  488.             Dies öffnet den ASLFileRequester. Wählt man etwas aus wird dies
  489.         einfach in das Command StringGadget kopiert.
  490.  
  491.     Cmd     [m|M]
  492.  
  493.             Dies führt einfach die Kommandozeile, die im Command StringGadget
  494.         steht, als ganze Zeile (unverändert) aus. man kann also auch PARAME-
  495.         TER und OPTIONEN an das Kommando übergeben.
  496.  
  497.         Z.B: kann man
  498.  
  499.                     'list df0:system/setm#?'    oder
  500.  
  501.                     'hdtoolbox'
  502.  
  503.     eingeben. Jede Ausgabe der Programme wird zum angegebenen Output gelenkt.
  504.  
  505.  
  506.     Iconify [i|I]
  507.  
  508.             Dies iconified das Fenster. Dazu kann man auch das ZoomGadget des
  509.         Fenster betätigen. Nach dem Iconifying erscheint ein kleines Fenster
  510.         am oberen linken Bildschirmrand. Beim erneuten Betätigen oder der
  511.         Eingabe von 'i' erscheint wieder das große Fenster von zuvor.
  512.  
  513. Bemerkung:  Besonders im iconify-ten Zustand zeigt sich der Vorteil, die Funk-
  514.         tionen auch mittels Tastendruck starten zu können. Alle Kommandos sind
  515.         so auch weiterhin ausführbar. So ist es , als erhielte man ein sehr
  516.         kleines Cli-Fenster, daß alle Programme in allen vorgestellten Modi
  517.         ausführen kann.(super was ?)
  518.  
  519.     Quit    [q|Q]
  520.             Beendet das Programm. Man kann anstatt 'q' auch das Schließgadget am
  521.         oberen linken Fensterrand betätigen.
  522.  
  523.  
  524.  
  525. Technisches:
  526.  
  527.  
  528.         EM wurde in C geschrieben und mit dem Manx Aztec C V 5.2a - Compiler
  529.         kompiliert.
  530.  
  531.  
  532.         EM benutzt die neuen DOS ReadArgs Funktionen für CommandLine-
  533.         Parsing. Das IntuitionInterface wird mit Hilfe der GadTools.Library
  534.         erstellt und verwaltet. Der FileRequester stammt aus der ASL.Library.
  535.  
  536.  
  537. Zum Schluß:
  538.  
  539.         Ich hoffe EM wird von vielen Leuten benutzt. Sollten sich Fehler des
  540.         Programms herausstellen, so schreibt mir. Auch konstruktive Kritik              und/oder Ideen sind willkommen.
  541.  
  542.  
  543. Adresse:
  544.  
  545. Schickt alle Anschriften bitte an:
  546.  
  547.  
  548.  
  549.                 Hans - Peter Günther
  550.  
  551.                 Grüner Weg 5
  552.  
  553.                 3501 Fuldatal 2
  554.  
  555.                 ( B.R.D )
  556.  
  557.  
  558. Viel Spaß noch mit EM ...
  559.  
  560.                 H.P.G
  561.  
  562.  
  563. PS:
  564.  
  565. Liste der Dateien:
  566.  
  567. (Fehlen ein oder mehrere dieser Dateien, ist diese Veröffentlichung inkomplett)
  568.  
  569.  
  570. ExecMaster           : Programm
  571. ExecMaster.info
  572. ExecMaster.dok       : deutsche Anleitung
  573. ExecMaster.dok.info
  574. ExecMaster.doc       : englische Anleitung
  575. ExecMaster.doc.info
  576. Examples (Dir)
  577.         .edrc.dme         : Teil einer DMe Startup-Datei
  578.         .edrc.dme.info
  579.         Csh.start.sh      : Teil einer CSH Startup-Datei
  580.         Csh.start.sh.info
  581.         EMaster           : Batch Datei
  582.         EMaster.info
  583.         User-Startup      : Teil einer User-Startup Datei
  584.         User-Startup.info
  585. Examples.info
  586.  
  587. ---
  588. ENDE
  589.  
  590.  
  591.  
  592.  
  593.